home *** CD-ROM | disk | FTP | other *** search
/ PC World Interactive 1 / PC World Interactive 1 - Nisan 1997.iso / nostalji / bbs / faq / gnweb.txt < prev    next >
Text File  |  1995-07-06  |  22KB  |  569 lines
  1. Newsgroups: comp.infosystems.gopher,comp.infosystems.www.servers.unix,news.answers
  2. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!news.kei.com!simtel!news.sprintlink.net!bga.com!garcon.unicom.com!unicom.com!not-for-mail
  3. From: chip@unicom.com (Chip Rosenthal)
  4. Subject: The GN Gopher/HTTP Server [monthly FAQ posting]
  5. Approved: news-answers-request@mit.edu
  6. Originator: chip@unicom.com (Chip Rosenthal)
  7. Message-ID: <gn-950706@unicom.com>
  8. Sender: chip@unicom.com (Chip Rosenthal)
  9. Supersedes: <gn-950521@unicom.com>
  10. Expires: Mon, 4 Sep 1995 09:55:40 GMT
  11. Summary: answers to frequently asked questions
  12. Organization: Unicom Systems Development, Austin, TX
  13. Date: Thu, 6 Jul 1995 09:55:40 GMT
  14. Followup-To: comp.infosystems.gopher
  15. X-Nntp-Posting-Host: chinacat.unicom.com
  16. Lines: 550
  17. Xref: senator-bedfellow.mit.edu comp.infosystems.gopher:17201 comp.infosystems.www.servers.unix:2277 news.answers:47827
  18.  
  19. Archive-name: gn
  20. News-answers-archive-name: www/gn-server/diff
  21. Posting-frequency: monthly
  22. Version: 1.7
  23.  
  24. @(#) gn 1.7 95/07/06 04:54:07
  25.  
  26. --------------------------------
  27.  
  28. Subject: 0. Welcome
  29.  
  30. Welcome to the GN FAQ!  This document answers many frequently-asked
  31. questions about GN, a free Gopher and World Wide Web server for Unix.
  32.  
  33. Please examine the date near the top of this message.  This message
  34. is updated from time to time, and older versions might be obsolete.
  35. The most up-to-date version of this FAQ may be retrieved from the
  36. following locations:
  37.  
  38.   - The World Wide Web -- http://www.unicom.com/FAQ/
  39.  
  40.   - The Internet Gopher -- gopher://gopher.unicom.com/11/FAQ
  41.  
  42.   - Anonymous FTP -- ftp.unicom.com:/pub/FAQ/gn
  43.  
  44.   - Email Archive Server
  45.       Mail to:  "archive-server@unicom.com".
  46.       Use a "Subject: send 00/FAQ/gn" email header.
  47.       Or use "Subject: help" for more info.
  48.       Body of message is ignored.
  49.  
  50. This message is maintained and posted monthly by Chip Rosenthal
  51. <chip@unicom.com>.  Your corrections, additions, and comments are
  52. encouraged.
  53.  
  54. Chip has been maintaing this document since May 95, when he took over
  55. from Stephen Trier.  The original draft was written by Rich Wiggins.
  56. Most of these questions were written by Rich and Stephen, to whom the
  57. current maintainer is grateful.  Additional contributions have been
  58. made by:  John Franks, E. Loren Buhle, Jr., Josh Smith, Michael Regoli,
  59. and Judy Birmingham -- as well as the many folks asking questions and
  60. giving answers on the gn-maint-l mailing list.  Thanks to all.
  61.  
  62. ------------------------------
  63.  
  64. Subject: 1. Table of Contents
  65.  
  66. The following questions are answered in this version of the FAQ:
  67.  
  68. 0. Welcome
  69. 1. Table of Contents
  70. 2. What is GN?
  71. 3. How does GN compare to University of Minnesota's gopherd?
  72. 4. What is the development and support status of GN?
  73. 5. Should I use GN as my WWW server?
  74. 6. Is GN free?
  75. 7. How can I see GN in action?
  76. 8. Where can I get GN?
  77. 9. Where can I get more info about GN or contact other GN users?
  78. 10. How do I subscribe/unsubscribe from the gn-maint-l mailing list?
  79. 11. Can I run GN and gopherd at the same time?
  80. 12. How do I make GN answer on both port 70 (gopher) and 80 (HTTP)?
  81. 13. I can't query a WAIS database on another computer.  Why not?
  82. 14. How can I gateway to FTP using GN?
  83. 15. How do I get gopherd or g2fd?
  84. 16. Can GN do gopher+?  Does GN support ASK blocks?
  85. 17. I converted from gopherd to GN, and now "waissrc:" doesn't work.
  86. 18. I converted from gopherd to GN, and now "ftp:" doesn't work.
  87. 19. What's the easiest way to serve the same document in HTML for WWW
  88.     clients and text for gopher clients?
  89. 20. GN is serving truncated documents and menus.  How do I fix it?
  90. 21. How do I add a link to a specific URL?
  91. 22. How can I point to an HTML file in my docs directory (or another
  92.     subdirectory) from the initial menu?
  93. 23. Can I write a GN script that automatically logs in on a telnet session?
  94. 24. Can GN scripts get interactive input from the user?
  95. 25. Is there an easy way of knowing which version of GN is
  96.     running on a particular host?
  97. 26. How do I set up clickable images?
  98. 27. I added a line to /etc/services for a service, but
  99.     inetd can't find the service.  What's wrong?
  100. 28. My inline images are showing up as "broken picture" icons.
  101.  
  102. ------------------------------
  103.  
  104. Subject: 2. What is GN?
  105.  
  106.     GN is a multi-protocol server for Gopher and World-Wide Web that
  107.     runs under Unix.  It was written by Dr. John Franks of Northwestern
  108.     University.
  109.  
  110.  * Huh?  Did you say GN can serve *both* Gopher and Web clients?
  111.  
  112.     Absolutely!  You can maintain one document tree and one set of
  113.     control files to manage both your Gopher and Web services.
  114.  
  115.  * How does GN do this magic?
  116.  
  117.     It is bilingual!  It recognizes the protocol spoken by the client,
  118.     either Gopher or HTTP (the language of the Web), and answers as
  119.     appropriate.  You use the GN "menu" files to specify which
  120.     documents may be served to Gopher clients, which may be served to
  121.     Web clients, and which may be served to both.
  122.  
  123.  * Does this mean that my Web pages end up looking like Gopher menus?
  124.  
  125.     Not at all!  GN provides you access to the full range of Web
  126.     features, including CGI forms and in-line images.  It is fully
  127.     fluent in HTML.  GN pages can look so good, a service running GN
  128.     won an award in the Best of the Web '94 competition!
  129.  
  130. ------------------------------
  131.  
  132. Subject: 3. How does GN compare to University of Minnesota's gopherd?
  133.  
  134. GN has some advantages and disadvantages with respect to the UMinn
  135. gopherd.
  136.  
  137. Here are some of the advantages:
  138.  
  139.     Predictibility - You always know what items GN will present and the
  140.     order in which things will appear because *you* control this
  141.     through the "menu" files.  (The "menu" files are analogous to
  142.     gopherd ".Links" files, with many added capabilities.)
  143.  
  144.     Implementation - We think GN is smaller, tighter, faster, and more
  145.     reliable.  For example, the (bloated) WAIS searching code is cast
  146.     off into a seperate "waisgn" executable.  This makes GN a lot
  147.     easier on the system when run out of "inetd".
  148.  
  149.     Security - Because you control precisely what documents the server
  150.     will provide, and because it is a "small" program, we believe it
  151.     provides positive security benefits.
  152.  
  153.     Licensing - The license for GN is clear and unambiguous.  It is
  154.     freeware.
  155.  
  156.     HTTP - If you are on the World Wide Web, GN allows you to serve
  157.     both Gopher and Web.  If you aren't doing WWW yet, then GN will
  158.     ease your transition the day you decide to.
  159.  
  160.     Active Community - A large number of sites run GN, and very good
  161.     support is available through the "gn-maint-l" mailing list.
  162.  
  163. Here are some of the disadvantages:
  164.  
  165.     No Gopher+:  GN is a gopher0-only server.  It does not support the
  166.     features of the gopher+ protocol, such as ASK blocks.
  167.  
  168.     No gateway support:  Although GN supports WAIS searches of
  169.     documents in your Gopher tree, it does not provide a gateway to
  170.     external WAIS servers.  Likewise, it does not include an FTP
  171.     gateway.
  172.  
  173. ------------------------------
  174.  
  175. Subject: ?. What is the development and support status of GN?
  176.  
  177. GN is a mature product.  Almost no new development is occurring on
  178. the product.  It is, however, actively maintained and supported by
  179. the author.  Also, the gn-maint-l mailing list (discussed shortly)
  180. provides an active forum for GN users and administrators.
  181.  
  182. ------------------------------
  183.  
  184. Subject: ?. Should I use GN as my WWW server?
  185.  
  186. If you need to support Gopher as well as the HTTP protocols, GN might
  187. be a very good choice.  It greatly reduces your administrative burden
  188. by providing both services through a single set of configuration and
  189. data files.
  190.  
  191. If, however, you have no need for Gopher support, you might find that
  192. some of the newer WWW servers provide a higher level of capability.
  193. In particular, you might want to look at WN, an HTTP-only server
  194. written by John Franks.  Additional information is available
  195. at <URL:http://hopf.math.nwu.edu/>.
  196.  
  197. ------------------------------
  198.  
  199. Subject: 4. Is GN free?
  200.  
  201. Yes.  GN is offered under the GNU Public License.  No royalties are
  202. required for any use, including commercial use or distribution.
  203.  
  204. (The University of Minnesota charges for commercial use of their Unix
  205. server.  Connect to their server (gopher.tc.umn.edu port 70) and look
  206. under "Information About Gopher" for details.)
  207.  
  208. ------------------------------
  209.  
  210. Subject: 5. How can I see GN in action?
  211.  
  212. GN's home server is hopf.math.nwu.edu.  This computer runs GN, and
  213. you can browse it with gopher or WWW to get a taste of its abilities.
  214. You will find very good online documentation, suitable for reading
  215. section-by-section -- or for printing in its entirety.  You'll also
  216. find online examples of how GN handles certain document types.
  217.  
  218. You may connect either via WWW <URL:http://hopf.math.nwu.edu:70/> or Gopher:
  219.  
  220.   Name=The home of GN (hopf.math.nwu.edu)
  221.   Path=
  222.   Type=1
  223.   Host=hopf.math.nwu.edu
  224.   Port=70
  225.  
  226. ------------------------------
  227.  
  228. Subject: 6. Where can I get GN?
  229.  
  230. GN is distributed by anonymous FTP from ftp.acns.nwu.edu in /pub/gn.
  231. To get GN, follow these steps:
  232.  
  233.   FTP to ftp.acns.nwu.edu
  234.   Log in as anonyous
  235.   Use your e-mail address as your password
  236.   cd /pub/gn
  237.   Fetch the files you need
  238.  
  239. The file will be called gn-2.##.tar.gz (where "2.##" really will appear
  240. as the current version number).  After you retrive the file you will need
  241. to uncompress it and unarchive it before you can configure it and build it.
  242.  
  243. The ".gz" suffix means the archive has been compressed with the GNU Zip
  244. ("gzip") utility.  This is somewhat similar to the standard Unix
  245. compress program (which produces ".Z" files).  Therefore, you need a
  246. copy of the GNU Zip package before you can even begin.  It is a popular
  247. program, and available on hundreds (thousands?) of archive sites throughout
  248. the world.  The home site for GNU software is prep.ai.mit.edu.
  249.  
  250. ------------------------------
  251.  
  252. Subject: 7. Where can I get more info about GN or contact other GN users?
  253.  
  254. There are a number of resources to help you learn about GN and help
  255. you administer your server.  We've already mentioned the hopf.math.nwu.edu
  256. server.  Here are a few more.
  257.  
  258. There is a mailing list called "gn-maint-l" dedicated to supporting
  259. GN users.  If you are the least bit interested in the package, you
  260. *want* to join list.  There is an extremely active community
  261. supporting GN, and they all hang out here.  The next section tells
  262. you how to join the list.
  263.  
  264. The Usenet comp.infosystems.gopher newsgroup is another resource.
  265. Note, however, that although many GN administrators read that group,
  266. most discussion specific to GN occurs on the gn-maint-l list.  The
  267. comp.infosystems.gopher group is still a good place to ask general
  268. Gopher protocol questions.  Also note that while all new versions of
  269. GN, including bug fix releases, are announced on gn-maint-l, only
  270. major revisions are announced in comp.infosystems.gopher.
  271.  
  272. Chip Rosenthal maintains a "GN Information page" with some useful
  273. tools for the GN administrator and pointers to other information.
  274. See <URL:http://www.unicom.com/gn-info/> or
  275. <URL:gopher://gopher.unicom.com/11/gn-info>.
  276.  
  277. ------------------------------
  278.  
  279. Subject: 8. How do I subscribe/unsubscribe from the gn-maint-l mailing list?
  280.  
  281. There is a mailing list for GN users, known as gn-maint-l.
  282.  
  283. To subscribe with the address from which you're sending mail, send a
  284. message to 'majordomo@hmc.edu', with "subscribe gn-maint-l" as the
  285. entire body (not the Subject: line) of the messge. To subscribe with
  286. some other address, do exactly as above, except use "subscribe
  287. gn-maint-l otheraddress" as the body, where "otheraddress" is the other
  288. address. (This second method requires the list maintainer's approval
  289. before it will take effect.)
  290.  
  291. For more information on using the mailing list server, send the
  292. one-line message "help" to majordomo@hmc.edu.
  293.  
  294. To unsubscribe, send the phrase "unsubscribe gn-maint-l" in a message
  295. body (not the subject) to majordomo@hmc.edu.  If that doesn't work,
  296. use "unsubscribe gn-maint-l <your-email-address>".  If all else fails,
  297. contact the human operating the list at owner-gn-maint-l@hmc.edu.
  298.  
  299. Be patient -- the first suggestion here works automatically, but the
  300. other two require human intervention and might take a day or two.
  301.  
  302. IMPORTANT:  Never send an unsubscription request to any other address,
  303. particularly the main list address.  This will NOT get you off the
  304. list.  All it does is broadcast your message to *all* of the other
  305. list members, who couldn't unsub you even if they wanted to.
  306.  
  307. ------------------------------
  308.  
  309. Subject: 9. Can I run GN and gopherd at the same time?
  310.  
  311. Yes.  They must be run on different ports and should have different
  312. data directories.  Here is an example:
  313.  
  314. Place appropriate entries for both ports in your /etc/services file
  315. (or NIS services map):
  316.  
  317.     gopher          70/tcp      # gopher server
  318.     gopher-gw4      2073/tcp    # gateway 4 for gopher server
  319.  
  320. The designation "gopher-gw4" and the port 2073 are arbitrary for the
  321. second server.  Use whatever name and port you wish.  Then add entries
  322. for each in /etc/inetd.conf:
  323.  
  324.     gopher      stream  tcp  nowait  nobody  /usr/local/libexec/gn gn
  325.     gopher-gw4  stream  tcp  nowait  nobody  /usr/local/libexec/gopherd gopherd
  326.  
  327. ------------------------------
  328.  
  329. Subject: 10. How do I make GN answer on both port 70 (gopher) and 80 (HTTP)?
  330.  
  331. Put two entries for GN in your inetd.conf, one on each port.  Unless
  332. you intentionally want the two GNs to return different data, both
  333. entries should have identical command-line options.
  334.  
  335. Here is an example:
  336.  
  337. Place appropriate entries for both ports in your /etc/services file
  338. (or NIS services map):
  339.  
  340.     gopher      70/tcp                  # gopher server
  341.     http        80/tcp          www     # HyperText Transfer Protocol for WWW
  342.  
  343. The next two lines go in /etc/inetd.conf:
  344.  
  345.     gopher      stream  tcp  nowait  nobody  /usr/local/libexec/gn gn
  346.     http        stream  tcp  nowait  nobody  /usr/local/libexec/gn gn
  347.  
  348. Notice that these lines are identical except for the port name.  The
  349. paths and options in your inetd.conf lines will be different, depending
  350. on how you have set up gopher.
  351.  
  352. Remember to tell inetd to re-read its configuration (probably "kill -HUP")
  353. after making the changes.
  354.  
  355. ------------------------------
  356.  
  357. Subject: 11. I can't query a WAIS database on another computer.  Why not?
  358.  
  359. GN uses WAIS only for local searches.  It cannot gateway to a remote
  360. WAIS server.
  361.  
  362. gopherd can be used as a gateway to remote WAIS servers.
  363.  
  364. ------------------------------
  365.  
  366. Subject: 12. How can I gateway to FTP using GN?
  367.  
  368. You cannot, at least not directly.  GN does not have a built-in FTP
  369. gateway.
  370.  
  371. You can install a separate gateway program to do FTP gatewaying.
  372. Suitable programs are gopherd and g2fd.
  373.  
  374. ------------------------------
  375.  
  376. Subject: 13. How do I get gopherd or g2fd?
  377.  
  378. For information on how to get GN, see question 4.
  379.  
  380. To get gopherd:
  381.  
  382.     Anonymous FTP to boombox.micro.umn.edu.  Look in the directory
  383.     /pub/gopher/Unix for a file with a name like, "gopher-2.nnn.tar.Z".
  384.     nnn is a version number which can't be predicted here.
  385.  
  386. To get g2fd:
  387.  
  388.     Anonymous FTP to boombox.micro.umn.edu.  Look in the directory
  389.     /pub/gopher/Unix/gopher-gateways/gopher2FTP.  The files ReadMe and
  390.     g2fd.c are the gateway.
  391.  
  392. ------------------------------
  393.  
  394. Subject: 14. Can GN do gopher+?  Does GN support ASK blocks?
  395.  
  396. No.  GN does not support any gopher+ features at this time.
  397.  
  398. ------------------------------
  399.  
  400. Subject: 15. I converted from gopherd to GN, and now "waissrc:" doesn't work.
  401.  
  402. GN uses a different syntax for WAIS searches.  Please see the
  403. documentation in the GN package for more details.
  404.  
  405. ------------------------------
  406.  
  407. Subject: 16. I converted from gopherd to GN, and now "ftp:" doesn't work.
  408.  
  409. GN does not have a built-in FTP gateway.  You must use an external
  410. gateway, such as g2fd or gopherd.
  411.  
  412. ------------------------------
  413.  
  414. Subject: 17. What's the easiest way to serve the same document in HTML
  415.              for WWW clients and text for gopher clients?
  416.  
  417. You need to have a plain text file as well as the html file. So. . .
  418. contruct the html file and put in a dummy text file . . anything will
  419. do (eg. "hi" is fine). This will allow the line in menu to work. For
  420. example, presume you have a file called junk.html  You should create a
  421. text file called  junk
  422.  
  423. Your menu entry will be:
  424.  
  425. Name=Name of the item
  426. Type=0h/junk     (I'm presuming this is in the top directory)
  427.  
  428. Then go mkcache
  429.  
  430. Read the file via a WWW-client (e.g. Mosaic) and SAVE it to a text
  431. file. The formatting will be done, stripping it of the html stuff. Then
  432. take this saved text file and copy it overtop (e.g.  mv new_stuff junk)
  433. and you are done. You should make sure none of the lines in the new
  434. text file are >80 characters in length, but that is all.
  435.  
  436. ------------------------------
  437.  
  438. Subject: 18. GN is serving truncated documents and menus.  How do I fix it?
  439.  
  440. Running a Streams-based TCP, eh?  If you are running 2.09 or later, go
  441. into "config.h" and enable DO_LINGER.
  442.  
  443. ------------------------------
  444.  
  445. Subject: 19. How do I add a link to a specific URL?
  446.  
  447. Version 2.09 of GN adds a new construct to the "menu" file.  Instead of
  448. making a "Name=" entry, use:
  449.  
  450.     URLlink=The change log for GN
  451.     Url=http://hopf.math.nwu.edu/docs/CHANGES
  452.  
  453. UrlLinks appear only to Web clients.  They are omitted from menus
  454. served to Gopher clients.
  455.  
  456. ------------------------------
  457.  
  458. Subject: 20. How can I point to an HTML file in my docs directory (or
  459.              another subdirectory) from the initial menu?
  460.  
  461. The trick here is that you need *two* menu entries for this file:  an
  462. entry in your main menu that provides a pointer to the file, and
  463. another in the docs directory that authorizes the access.  If you do
  464. not want the file to appear in the listing provided for the docs
  465. subdirectory, then you may specify Attribute=Invisible there.  Also, if
  466. you have just an HTML version of the document you might want to say
  467. Attribute=HttpOnly in the main menu entry to prevent Gopher clients
  468. from seeing it.
  469.  
  470. Here is an example:
  471.  
  472.     # In data-directory/menu
  473.     Name=some HTML document
  474.     Path=0/docs/myfile
  475.     ContentType=text/html
  476.     Attribute=HttpOnly
  477.  
  478.     # In data-directory/docs/menu
  479.     Name=dummy entry to allow file to be served
  480.     Path=0/docs/myfile
  481.     ContentType=text/html
  482.     Attribute=Invisible
  483.  
  484. Note that the "ContentType" records can be removed if the file is
  485. called "myfile.html" instead of just "myfile".  If you have both HTML
  486. and plaintext versions, then use an "0h" instead of "0" selector and
  487. dump the "HttpOnly" attribute (and leave off the ".html").
  488.  
  489. ------------------------------
  490.  
  491. Subject: 21. Can I write a GN script that automatically logs in on a
  492.          telnet session?
  493.  
  494. No, this can't be done.  Scripts run on the gopher server, but telnet
  495. sessions run on the _client_ computer.  The gopher server isn't
  496. consulted at all when the client launches a telnet session; it goes
  497. straight to its destination, not through the server.
  498.  
  499. This is the way the gopher protocol itself is designed, so you'll find
  500. the same no-scripted-telnet prohibition in all gopher servers, not just
  501. GN.
  502.  
  503. ------------------------------
  504.  
  505. Subject: 22. Can GN scripts get interactive input from the user?
  506.  
  507. No.  This is a limitation of the gopher protocol.  It restricts all
  508. gopher servers, not just GN.
  509.  
  510. If you really need interactivity, you will have to attach your script
  511. to a telnet login or a port in inetd, then point a type 8 (telnet) item
  512. to the script's home.
  513.  
  514. ------------------------------
  515.  
  516. Subject: 23. Is there an easy way of knowing which version of GN is
  517.              running on a particular host?
  518.  
  519. Yes!  Telnet to the host and port in question, type "HEAD / HTTP/1.0",
  520. then press Enter twice.  GN will respond with several lines of information,
  521. one item of which will be its version number.
  522.  
  523. This works with most HTTP servers, not only GN.
  524.  
  525. ------------------------------
  526.  
  527. Subject: 24. How do I set up clickable images?
  528.  
  529. Judy Birmingham has written a guide to how to set up clickable images
  530. in GN.  See <URL:http://sparc2.sparcc.ohio.gov:70/0h/basics/wgs95/click.html>.
  531.  
  532. ------------------------------
  533.  
  534. Subject: 25. I added a line to /etc/services for a service, but
  535.              inetd can't find the service.  What's wrong?
  536.  
  537. Your system is probably using YP (Yellow Pages), which is also known as
  538. NIS (Network Information Service).  If NIS or YP is active, changing
  539. the local /etc/services file has no effect.  You need to change the
  540. services file on the YP server.
  541.  
  542. Users on systems using YP can check up on the YP services file with the
  543. command "ypcat services".
  544.  
  545. ------------------------------
  546.  
  547. Subject: 26. My inline images are showing up as "broken picture" icons.
  548.  
  549. You're probably missing a menu file entry like this:
  550.  
  551.     Name=dummy entry for foo.gif to keep GN happy
  552.     Path=I/foo.gif
  553.     Attribute=invisible
  554.  
  555. Every file GN serves must have a Name and Path entry in its menu file,
  556. or GN won't deliver it.  Inline images are files, so they need their
  557. Name and Path entries.  We've added "Attribute=invisible" to prevent
  558. this entry from appearing in the menu listing provided to the client.
  559. If the image and the HTML document are in different directories, this
  560. entry goes in the menu file for the directory in which the image
  561. resides.
  562.  
  563. [ end of gn 1.7 ]
  564. -- 
  565. Chip Rosenthal                They said I was just a dumb cowpoke.
  566. Unicom Systems Development    I didn't want to make a fuss.  - Robert Earl Keen
  567. For a good time: http://www.unicom.com/john-hiatt/
  568. PGP key: http://www.unicom.com/personal/chip.html
  569.